While each production environment is unique in its configuration, the following steps provide a basic guideline for configuring and executing well test actions. Perform the following steps to install the necessary system components, create a CygNet well test configuration, and execute the test action to generate well test results.
Acquire the appropriate CygNet Well Test license file from your CygNet Sales account manager. Apply the license file to the Address Resolution Service (ARS) that is designated as the License Master for your installation.
A license check will be performed when you open the CygNet Well Test Configuration plugin (CygNet.API.WellTest.Controls.dll) described below in step 6.
Using CInstall, install and launch the CygNet Well Test Windows Service application from the BIN BLOB folder. This will download the service executable to the \Bin directory and install a Windows service called CygNet Well Test.
See CygNet Well Test Windows Service for more information about this service.
The service requires a Windows Service config file, which points to the configuration point that will contain the well test configuration XML (to be created in step 7 below).
Using an XML or text editor create an XML file called "WellTestServiceConfig.xml" file and save it to the \Bin directory. The file should look like the following example. There can be one or more "Point" nodes that define from where the well test configuration XML will be loaded.
|
<WellTest> <ConfigurationPoints> <Point>SITENAME.UIS:LONG_ID</Point> </ConfigurationPoints> </WellTest> |
Using CygNet Explorer, create the well test configuration point in the PNT. Once the XML is created (in step 7 below), you will save or copy the well test configuration XML into this point’s HyperPoint Script Text.
Also create the Header Point, Header Queue Points, any necessary well test UDCs. Make sure your well facility configurations are in order.
Note: There can be more than one configuration point.
If you plan to reference relative facilities in your well test configuration, you will need to create a relative facilities definition file, prior to configuring the well test actions.
See Creating the Relative Facilities File for more information about how to do this.
The CygNet.API.WellTest.Controls.dll is a plugin control assembly that can be made available for use in the Canvas application to allow the manual configuration of the well test configuration XML file. This plugin provides a user-friendly method for defining the necessary elements required to execute a well test via a Canvas screen. The plugin is in the \Bin directory.
Using this assembly and a well test configuration screen you can easily define the necessary well test properties: point scheme, data retention value, relative facilities, UDCs, headers, wells in the well test, header templates, positions, commands, and associated actions for each command.
See Configuring Well Test Using Canvas for more information about installing the plugin.
The CygNet Well Test Module uses Canvas HMI screens to configure the well test actions. Several sample files have been provided to assist in this process. The well test sample files can be found on the CD_Image in the Samples\Well Test folder. You must copy the files from the CD_Image to a known location on your host server. See Sample Well Test Screens and Scripts for more information.
Start with the sample screen Well Test Configuration.can to create the XML required to execute well test.
See Configuring Well Test Using Canvas for more information about configuring the well test configuration XML.
Alternately, if you prefer to work in the raw XML, use an XML or text editor to write the XML configuration to perform the well test actions.
See Configuring Well Test Using XML for more information about the XML elements and attributes, and code examples.
The XML configuration must be saved to the well test configuration point before executing the well test. This can be done automatically using the Well Test Configuration.can screen or saved manually via CygNet Explorer.
The CygNet Well Test Module uses Canvas HMI screens to execute and visualize well test status and well detail information. The well test sample files can be found on the CD_Image in the Samples\Well Test folder. You must copy the files from the CD_Image to a known location on your host server.
The sample Canvas screens supplied with CygNet can be used to help test the well test configuration.
See Sample Well Test Screens and Scripts for instructions on customizing the screens for your test environment. Also included in that section is a description on how to use the screens to interact with the well test process.
To test the configuration:
- Select a test facility to test
- Add a well (or wells) to the queue
- Start the queue
- Verify that the actions work as expected
More:
Configuring Well Test Using Canvas
Configuring Well Test Using XML
Creating the Relative Facilities File